home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / actv333.zip / ACTVIEW.DOC next >
Text File  |  1993-01-01  |  16KB  |  349 lines
  1.  ---------------------------------------------------------------------------
  2.                                ACTVIEW 3.33 (c)
  3.                     Wildcat! Activity Log Viewer/Analyzer
  4.                       Copyright (c) 1993 by Greg Wilson
  5.                              All Rights Reserved
  6.                                    01/01/93
  7.                              Author: Greg Wilson
  8.  ---------------------------------------------------------------------------
  9.  
  10.                                    Purpose
  11.                                    -------
  12.  Actview was written out of my own need for a tool to assist with reading  the
  13.  activity log of my BBS.  The task of viewing the  log with a file viewer  was
  14.  taking too long and I found myself rushing through the process, missing  many
  15.  important events such as system errors and invalid logon attempts.
  16.  
  17.  Actview started as a simple program that produced a one line per call  report
  18.  with a few flags. After getting  input from some fellow sysops, I  decided to
  19.  write a complete activity log viewer!
  20.  
  21.                                  Instructions
  22.                                  ------------
  23.  For  a  quick  look  at  what  Actview  has to offer, copy ACTVIEW.EXE to the
  24.  directory containing your activity log(s) and  run it. If you have more  than
  25.  one node, you will  have to build a  file named ACTVIEW.CFG (see  below). The
  26.  program will display the last recorded day's activity in a one line per  call
  27.  format with the  critical information shown.  At the top  of the screen,  the
  28.  range of dates in the log is displayed along with the date of the information
  29.  being displayed.
  30.  
  31.  For other  functions available  (and there  are many!),  press ALT-M  for the
  32.  menu.  Most are self explanatory.  If you do not like menus, you can use  the
  33.  built in  key functions  (press F1  for a  list).   For more information, see
  34.  below.
  35.  
  36.  
  37.  NEW FEATURES: Actview now allows the  user to go directly to WCPro,  QuesView
  38.  and the  DOS prompt  by pressing  ALT-E. Actview  is swapped  to XMS/EMS/Disk
  39.  before the  program is  called. When  WCPro/QuesView/Dos prompt  is done, the
  40.  program returns to exactly where you  left off! This functions can be  called
  41.  from anywhere within Actview. >REGISTRATION IS REQUIRED<
  42.  
  43.  
  44.  Key     Function
  45.  ------------------------------------------------------------------------
  46.  F1    - Displays the help window.
  47.  F2    - Swaps to another node's log. Directories to your different logs must
  48.          be entered in a file named ACTVIEW.CFG (see below).
  49.  F3    - Displays the following activity:
  50.          * Events
  51.          * Wildcat system errors such as files missing.
  52.          * Changes to the user's record such as changing birth dates,
  53.            passwords, ..etc.
  54.          * File overwrites.
  55.          * Invalid logon attempts. When detail is viewed for invalid logon
  56.            attempt, the next call is displayed for reference.
  57.          To return to the normal display, hit escape.
  58.  F4    - Displays totals for the currently displayed date.
  59.  F5    - Displays new users for the day showing their city and state.
  60.          To return to the normal display, hit escape.
  61.  F6    - Allows jumping directly to any date in the activity log.
  62.  
  63.  F7    - Jumps to the previous day's activity.
  64.  F8    - Jumps to the next day's activity.
  65.  F9    - Displays all calls of a specified user. The program will prompt for
  66.          user name, beginning date, and ending date of search. The name will
  67.          default to the highlighted call. The dates will default to the
  68.          beginning and end of the activity log. Actview will scan the log
  69.          finding all matching calls and then display the calls in the usual
  70.          one line per call format. To view totals for the user, hit F4. To
  71.          return to the normal display, hit Escape. To abort the search, press
  72.          the space bar.
  73.  F10 or ALT-X - Quits to DOS.
  74.  ALT-E - External program menu. This option allows Actview to call WCPro,
  75.          QuesView and shell to DOS. Actview is swapped to XMS/EMS/DISK. This
  76.          features requires registration.
  77.  ALT-F - Display the ACTVIEW.FLG file (see below)
  78.  ALT-L - Toggles local calls. Local calls will not be displayed or
  79.          included in the daily counts.
  80.  ALT-S - Allows the entire activity log(s) to be searched for a given string
  81.          (such as filename, Message#, ..etc.). Here are some ways I use this
  82.          feature:
  83.          * Search for all activity related to a particular file.
  84.          * Search for all activity related to a bulletin or door.
  85.          * Find all users that still use XMODEM.
  86.          * See who is using TomCat.
  87.          * See who has exceeded their time limit.
  88.          * ...etc.!
  89.  ALT-D - View all downloads for the day.
  90.  ALT-U - View all uploads for the day with descriptions (if available).
  91.  ALT-O - Sort calls. Actview will display a menu of 7 different sort types.
  92.          This function also works while viewing downloads and uploads.
  93.  ALT-V - View all activity logs for all nodes. Every log in the ACTVIEW.CFG
  94.          file is scanned for the currently displayed date and the calls are
  95.          loaded. This is a major time saver!
  96.  
  97.  
  98.  A typical Actview session would go something like:
  99.  
  100.       * Type ACTVIEW (if multi-node use the VIRT parameter to load all logs).
  101.       * Hit F3; if any errors are displayed, view the detail.
  102.       * Hit F5; view new users.
  103.       * Hit ALT-U to see what was uploaded.
  104.       * Hit ALT-D to see what was downloaded.
  105.       * Hit ESC to go back to viewing all calls.
  106.       * Scroll though the summary looking for uploads, msgs, carrier
  107.         drops and pages viewing the detail of these activities if desired.
  108.       * At any time, from any screen, WCPro and QuesView can be called (ALT-E).
  109.  
  110.  
  111.  An average review takes me about 2 minutes compared to 20 minutes before
  112.  I had ACTVIEW!
  113.  
  114.                               User Defined Flags
  115.                               ------------------
  116.  
  117.  Actview allows  sysops to  define flags  to indicate  that a certain activity
  118.  has occurred during a  call. These one character  flags are displayed on  the
  119.  initial call summary screen and are defined in the file ACTVIEW.FLG. This has
  120.  many uses including:
  121.  
  122.                 * Flag all users that download a certain file
  123.                 * Flag all users that use a certain door
  124.                 * Flag all users that drop carrier
  125.                 * Flag all users that exceed their download ratio
  126.                 * Flag all users that leave a message in a certain folder
  127.                 * Flag all users that complete a certain questionnaire
  128.                 * .. etc.
  129.  
  130.  A flag  is a  single character  to be  displayed in  the flag  column on  the
  131.  summary screen. Up  to 5 flags  can be displayed  for a single  call. If more
  132.  than 5 flags are found, the last flag will be then character "*". Also,  when
  133.  viewing the detail of a call, any lines that contain the flag string will  be
  134.  highlighted. In  the ACTVIEW.FLG  file, the  first column  contains the  flag
  135.  character to  be displayed.  The string  to turn  on the  flag is enclosed in
  136.  quotes on the same line as the flag character.
  137.  
  138.  Example: If an additional  flag was desired to  show any activity related  to
  139.  the file "FILELIST.ZIP",  ACTVIEW.FLG would be  updated as follows  (remember
  140.  that the flag characters must be in column 1):
  141.  
  142.                                E "ERROR"
  143.                                C "DROPPING CARRIER"
  144.                                D "OVER DOWNLOAD RATIO"
  145.                                M "MNP:YES"
  146.                                F "FILELIST.ZIP"
  147.                                V "ACTVIEW.ZIP"
  148.  
  149.                      ***    Note: Case is ignored    ***
  150.  
  151.  See the file  ACTVIEW.FLG for more  examples. The initial  flags for dropping
  152.  carrier, errors, new users, and exceeding download ratio are already set up.
  153.  
  154.  
  155.  
  156.  
  157.                              Multi Node Features
  158.                              -------------------
  159.  
  160.  For  multi-node  operation,  create  a   file  named  ACTVIEW.CFG  with   the
  161.  directories and filenames in the following format: (in column 1)
  162.  
  163.                              C:\WC30\ACTIVITY.001
  164.                              C:\WC30\ACTIVITY.002
  165.                              C:\WC30\ACTIVITY.003
  166.                              C:\WC30\ACTIVITY.004
  167.  
  168.  The entire path *and* filename must be specified in each line.
  169.  
  170.  NOTE: ACTVIEW.CFG must be in the same directory as ACTVIEW.EXE
  171.  
  172.  This feature may also be useful  for single node sysops that maintain  backup
  173.  copies of their logs under other  names and/or directories and still want  to
  174.  access them via Actview.
  175.  
  176.  NOTE: Actview  only opens  the ACTIVITY.LOG  when needed  and closed the file
  177.  during all  other activities  therefore allowing  Wildcat to  keep writing to
  178.  the  log  without  any  type  of  share violation. This greatly increases the
  179.  reliability of Actview  when using on  a log that  is currently active.  This
  180.  also gives  the ability  to view  the current  callers activity  to see  what
  181.  he/she just did.
  182.  
  183.  
  184.  
  185.                               Actview parameters
  186.                               ------------------
  187.  
  188.           ACTVIEW mm/dd/yy NOLocal ERRors NEW NODE=x MONO SNOW BIOS
  189.  
  190.             mm/dd/yy - Go directly to mm/dd/yy.
  191.             HELP     - Display help screen.
  192.             NOLocal  - Do not show local calls (ALT-L toggles).
  193.             ERRors   - Show errors for the day (F3 toggles).
  194.             NEW      - Show new users only (F5 toggles).
  195.             NODE=x   - Go to node x. ACTVIEW.CFG must be present.
  196.             MONO     - Force monochrome attributes.
  197.             NOMOUSE  - Turn Off Mouse support (speeds up entry and exit).
  198.             SNOW     - Turn on snow checking during screen writes.
  199.             VIRT     - View all nodes at once (ACTVIEW.CFG required).
  200.             BIOS     - Use bios screen writes. This option is not necessary
  201.                        when running Actview under Desqview because checks for
  202.                        Desqview are made and direct screen writes are
  203.                        re-mapped accordingly. BIOS writes are much slower than
  204.                        the normal direct screen writes and should not be used
  205.                        unless necessary.
  206.             25       - Set 25 line mode
  207.             43       - Set 43 line mode (EGA)
  208.             50       - Set 50 line mode (VGA)
  209.  
  210.  
  211.  
  212.                            Requirements and Limits
  213.                            -----------------------
  214.  * ACTVIEW has been tested with the activity logs created by Wildcat
  215.    3.50, 3.02, 3.01, 3.0, 2.55, 2.50, 2.15, 2.0 and the Wildcat Test Drive!
  216.  
  217.  * ACTVIEW is Desqview aware. No extra parameters are needed.
  218.  
  219.                       Memory requirements: 220k (Multi node see note)
  220.                  Max nodes in ACTVIEW.CFG: 100
  221.                                 Max flags: 100
  222.  
  223.   Max number of displayed calls is  now only limited by the available  memory.
  224.   The max number is displayed in the help window. This is also the max  number
  225.   of hits  when searching  (ALT-S or  F9). If  the search  finds more than the
  226.   available number  of displayed  calls, a  message will  be displayed and the
  227.   search will be halted.
  228.  
  229.   Multi-node note: If your BBS receives  a lot of calls each day,  more memory
  230.   will be needed to  view the calls. With  180k, only about 400  calls per day
  231.   are allowed to be  viewed at once. The  max number of calls  is displayed in
  232.   the help window.
  233.  
  234.  * Actview opens the ACTIVITY.LOG's in READ ONLY mode. *No* writes are made to
  235.    *any* files (except a swap file during external program calls (ALT-E)).
  236.  
  237.                                   Liability
  238.                                   ---------
  239.  
  240.  Actview  has  been   tested  on  multiple   machines  using  many   different
  241.  configurations and  no problems  have occurred.  However, if  a problem  does
  242.  arise due to Actview, I cannot be held responsible. Use at your own risk.
  243.  
  244.  
  245.  
  246.                         Distribution and Registration
  247.                         -----------------------------
  248.  
  249.  Actview may be freely distributed only as the following unaltered files:
  250.  
  251.                                  ACTVIEW.EXE
  252.                                  ACTVIEW.FLG
  253.                                  ACTVIEW.DOC
  254.                                  ACTVIEW.HIS
  255.                                  READ.ME
  256.                                  REGISTER.DOC
  257.  
  258.  
  259.  ACTVIEW is   not free.  You must  register after  the 30-day  evaluation time
  260.  period.
  261.  
  262.  ACTVIEW is  a Shareware  product.   It is  distributed through  public access
  263.  channels so that perspective buyers can have the opportunity to evaluate  the
  264.  product before making a  decision to buy. If you decide to use this software,
  265.  then you are under  both legal and moral  obligation to register it  with the
  266.  author. But if you  decide not to use  it after evaluating the  software, you
  267.  are  under  no  obligation.  It  is  fully  protected  by  State, Federal and
  268.  International copyright laws.
  269.  
  270.  If you continue to  use ACTVIEW after the  30-day evaluation time period  you
  271.  must register it.
  272.  
  273.                             Registration Fee  : $25 US
  274.  
  275.  Why Register?
  276.  --------------------------------------------------------------------
  277.  * The external call menu is enabled (ALT-E)
  278.  * All opening and closing screens are removed!
  279.  * Registered users have access to the Actview support BBS is granted!
  280.  * All Actview reports can be downloaded from the support BBS!
  281.  * All future updates are free!
  282.  
  283.  To register ACTVIEW, complete in the order form (REGISTER.DOC) and mail along
  284.  with your check or money order payable to "Greg Wilson" to:
  285.  
  286.  
  287.                                  Greg Wilson
  288.                            1252 Fordham Drive #101
  289.                           Glendale Heights, Il 60139
  290.  
  291.                               BBS: 708-752-4303
  292.  
  293.  
  294.  ██████████████████████████████████████████████████████████████████████████████
  295.                 * Credit Card Orders (VISA/MC/Discover/Amex) *
  296.  ██████████████████████████████████████████████████████████████████████████████
  297.  
  298.          Visa/MC/Amex/Discover (via the Public Software Library):
  299.  
  300.                         1-800-2424-PSL or 713-524-6394
  301.                         FAX: 1-713-524-6398
  302.                         CIS Email: 71355,470
  303.  
  304.                                 Product #10407
  305.  
  306.                     Credit card Price is $25 + $3 handling
  307.  
  308.                       THESE NUMBERS ARE FOR ORDERS ONLY!
  309.  
  310.                Do not call these numbers for technical support!
  311.  
  312.       All orders are relayed back to me the same day the order is made.
  313.  
  314.     The registered version can be shipped, uploaded or downloaded from my
  315.                             BBS or via CompuServe.
  316.  
  317.  ██████████████████████████████████████████████████████████████████████████████
  318.  
  319.  
  320.  
  321.                                    Credits
  322.                                    -------
  323.  Swapping  of  Actview  to  XMS/EMS/Disk  was  built using SPAWNO v4.1 by Ralf
  324.  Brown
  325.  
  326.  Screen I/O, data  entry screens and  popup windows were  built using TCXL  by
  327.  Innovative Data Concepts
  328.  
  329.  
  330.  
  331.                             Contacting the Author
  332.                             ---------------------
  333.  
  334.  I can be reached for  comments, questions, suggestions, complaints, etc.,  at
  335.  the following EMAIL boxes:
  336.  
  337.  
  338.           My BBS            (SYSOP)            - mail checked daily
  339.           Mustang BBS       (GREG WILSON)      - mail checked daily
  340.           The Source        (GREG WILSON)      - mail checked daily
  341.           CompuServe        (76547,3106)       - mail checked daily
  342.           EXEC-PC           (GREGORY WILSON)   - mail checked daily
  343.           Channel 1         (GREG WILSON)      - mail checked daily
  344.           PC-Ohio           (GREG WILSON)      - mail checked daily
  345.           Executive Network (GREG WILSON)      - mail checked daily
  346.  
  347.  
  348.                                     -end-
  349.